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ABSTRACT _ ^ ^ 

--- ^ T6is paper deals with the issues related to the 
dessi^ and distribution of microcomputer software, focusing on 

agricultural software and its users in developing countries 

(researcliers, Estension educato?i, planners The paper is 

organized in four sections that discuss the following topicsi _ 

def ill ifig t^e audience and software needs; -s^ evaluation; steps 

in seftil^are de^elopaient; and software di^ 

Support^^%e-]^per provides general informt ion abou^ these areas and 
offers some specific guidance related to software development and 
development of users * manuals and other consui^er helps. Ascend ixes 
identify areas in which microcomputers may be used in developing 
countries for finance and economics and summarize the components of 
microcomputer software design. (KC) 
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Issues Related to HIcriMcnptit^ Aj^lcultiirai S^tmre 
Design and Distribution In Developing Cbuiitrlesl 



There 1s little doubt that microcomputer applications will continue to 
Increase in developing countries. This tool allows for decentralization of 
canpiiter use and puts the computer in the hands of the researcher* extension 
specialist and planner. The usefulness of the micrbcdmputer, however, will 
always be limited by the availability of: 

li Appropriate software. 

2. Good relevant data. 

3. Subject matter knowledge to combine with the computer infbrmatidh. 

4. A committment to learn how to effectively use the tool. 



This paper will focus on the issues related to design and distribution of 
microcomputer software. The focus is on the users (researchers. Extension 
educators, planners, lenders, etc.) and agricultural software. Specifically, 
the paper discusses four issues which include: 



1. Defining the audience and software heeds. 

2. Software evaluation^ i 

3. Steps in software developent. 

4. Software distribution and maintenance support. 



Appendix A, as defined by Salzburg Seminar Fellows in Session 240, 
identifies areas in which microcomputers may potentially be used in developing 
couhtribS for finance and ecbndihics. 



:: z 1 Prejjared fbr the Salzburg Seminar, Session 240, by Dr. James M. 
HcSrarirt, Professor, Department of Agricultural Economics, Texas A&M 
University, Cbllege Station, Texas, April 1985. 
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Defining Audloice ami Needs 

The microcomputer and its software are tools that serve as 
extensions of the human m1hd. Successful application of the tools 
requires Identification of specific audience characteristics and their 
needs. In developing countries, for the most part, microcomputers 
Will not be used for sometime by individual farmers. Instead, 
supporting individuals above the farm-level decision makers. Satk as 
researchers, extension workers, policy makers, lenders, etc., tftat get 
Involved in decisidn-making through teehnbldgy selection in^ 
feconjmendatibns that are followed by Individual fanners. To identify 
potential applications of the computer requires a knowledge of the 
farm decision environment, as well as an understanding of the user 
subject matter knowledge level. 

fo define needs i users should have some knowledge of the 
applications and limitations of the microcomputer; then systematically 
list activities throughout the year where a compt'ter application would 
be appropriate. 

There are two rules to follow in defining software needs for any 
specific audience. They are as follows: 

i. Involve the end user in the process of defining needs; 

2* Define tfte final information needs af users of the computer 

software before addressing issues related to data gathering and 

processing. 

The goal of any microcomputer appli(Eatibn effort is to improve 
the existing methods used to process data and generate information. 
Often, simple applications have greater positive impacts. The "KISS" 
approach has validity in microcomputer applications, which is -Keep it 
slaple sti^ld-. 
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Pfioritjr selections are difficult, but essential, in that seldbiri 
are there sufficient resources to meet all needs. Again, involve the 
user in defining priorities. 

li. SoftMfe ivaluatlbn 

Dnce the audience needs and software priorities are defined, a 
systematic effort should be made to evaluate existing software to see 
If it can meet, or be adapted to meet, those specific ineedCs)* 

Software evaluations should consider both ttie subject matter 
content and the programmihg evaluation. This Is true for software 
developed using a specific prbgramming code, software development 
using spreadsheets, or data base software. 

the subject matter level of evaluation should consider: 
1. Does it do what is needed? 

2* Is the methodology used in the analysis appropriate? 
3. is the program well documented (coded if applicable] and the 
user's manual complete? 

If the user's manual is hot complete. It 1s often difficult to 
process the "calculation" procedures (algorithm) used in the program. 
Rhb'tpTed^e of the calculation procedures is essential in evaluating the 
software the subject matter software. 

The programming^ or technical evaluation, deals with the 
presentation of inputs and outputs, and program operation. High 
quality software also has error checks bh data entry and file 
managenent. Many bf the features associated with "ease cf use" and 
"bri-lihe" user instructions are very helpful in the initial use bf a 
program. The usefulness of these features diminish as one becomes 
more accustomed to the software. When possible, having the option to 
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override some of the dperatlon Instructions is helpful. Because of 
the importance of the knowledge of programnlng procedures! one should 
have a qualified programmer or system analyst involved in the 
technical review of software. 

Quality software also has an artistic component that is a 
function of the programmer's capabilities. This is difficult to 
describe but easy to see once software is used. 

After the audience and their needs are defined and available 
software evaluated, then if it is necessary to develop new software^ 
the priority areas must be redefined ^ Software developers should 
return to the user to reconfirm needs and gain a committment for 
participation. The following section describes the steps in software 
development. 

III. Steps tn Software DevelopMoit 

Development of microcdmputer software follows a procedure similar 
tt» any other scientific development work. This is true whether the 
program is going to be formatted into an electronic spreadsheet, or 
simply using a computer language. The basic steps to follow in 
software development can be sumnarized as follows: 

1. Prpbl em definition. 

2. Research and software rev ieWi 

3. Program design and manual preparation ^ 

4. Program coding. ^ 

5. Program dbcumentatibh and final manual completion. 

6* Program review, verification, field testing and revision. 
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Following these steps can save the programiner time, an often 
scarce resource, and Insure a quality product that meets clientele 
heeds. Bescrlbed are each of the previously mentioned steps In more 
detail. 

Problem Definition 

Problem definition Is the single most Important step In 
successful software development. Good problem definition, to identify 
needs, requires subject-iSatter knowledge of the problem environment 
and close cdomunlcatlon with the potential end users. In order to 
define areas where software development can be useful, the designer 
must have knowledge of how the computer can be us^ to faclHtate data 
generation, storage arid processlrig. The designer must also be aware 
of how much knowledge the targeted end user has concerning the 
application being designed, as well as the type of data that is 
available to the users It is extremely important that the designer 
consider erid user input in defining the problems to be addressed in 
software developent^ 
Research ana^joftwara^jew 

Not orily do such reviews prevent a duplicatiori of efforts, it 
also enhances the possibility of building on another persbri's research 
arid software experience to make a higher quality product. Few 
software developmerit erideavors. begin as "completely new", on the 
cbritrary, most software packages build on previous research efforts 
and software development. 

The identifieatibri arid review of existing software is not asn easy 
task; One problem is the process of actually gaining access to 
Irifbrmation on available software. A number of public arid private 



agricultural software , source lists, and computer newsletters are 
normally available from software vendors and software supplying 
Institutions that can be useful In identifying available software. 
One can anticipate that there will be a growth In the publication of 
articles on software that will Improve Information flows, thus, making 
It easier to Identify and review existing software packages. 

ince existing software has been Identified, it is almost a 
necessity to gain access to the software package for a hahds-dn 
review. It Is very difficult to fully understand the capabilities and 
limitations of a prograuri without actually using It on a computer. If 
the software cannot be acquired, the authors can be contacted directly 
to determine If the software addresses the Identified needs ^ 

Once tiie problem has been defined, the designer needs to review 
previous research relevant to the problem In question to determine if 
existing software is adequate. 

A literature review of previous research should preceed existing 
software reviews to insure all relevant information Is assembled prior 
to software evaluation. The research review will insure that relevant 
Information was not overlooked by the designers of the existing 
software and also identify the potential heed for additibhal research 
1h other areas ^ 

Software Design and Manual Preparatioti 

Once the designer/researcher is satisfied that a ^ew piece of 
software is necessary to solve a problem, it is time to begin the 
actual design. The software design is the organization and 
description of the software that Is to be programmed. The 
coftjuhicatlbh link between the potential users of the software, the 
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designer, tfie programmer and subject matter specialist put the Ideas 
together. The software design is the most creative part of software 
developments 

Listed below are some components a designer might want to 
consider In putting together a software package for a programmer to 
follow.' 



1. A precise descriptive title. 

2. A c1 earl stated objective of the software and the specific 
clientele it will serve* 

3. A J1agram{s) of the program structure and linkages (flow 
charts are useful tools). 

4. Data entry screens^ arid Variable reguirements— A data entry 
screen may consist of several questions for the user of the 
software to answer. Each question needs to cdritairi such 
Information as types of error checks i data ranges and help 
guides. 

5. Mistake correction rout1ne--th1s gives the user the 
opportunity to review and correct ariy erroneous data entered. 

6. The calculatliri procedure or prdgrara algorithm.— All variables 
must be^ clearly labeled and formulas specified so they are 
easy to follow between data input and outfiuts. Notes to the 
prpgramner can be very helpful In establishing the clarity 
needed for this section of a design. 

7. Specific laydut(s) for output(s) or report(sj. 

8. Information dealing with disk storage arid retrieval 
capabilities. 

9. Example(sj worfced out usirig the data entry screens, formulas 
and output reports for each option (worklnj examples before 
designs are programmed is a Jcey to efficient software 
deveibpmerit)i 

10. A prelljniriary user's manual for the sbftware^should be 
prepared before the desigri is ^iveri to the programmer. This 
can again increase the 4Ua^ity of the desigri and improve 
coninuriicatlbn with the programmer|si (Components of the users 
tnariual are discussed in detail later). 

11. Subject matter and system design review— It Is valuable to 
haye desiBn reviews by experienced prbfessibrials arid users to 
Incorporate these ideas into a final desigri. 



12. An indepth reviiw wtth tKe jrdframmer(sj--The working 
relationship should be established for ebh tin tied cbninuhlcati bh 
In the cbding phase bf software develbpmeht. 

Sbiiie bf the tasks previously mentioned can be difficult for 
sbmebrie whb has little or no computer experience, therefore. It Is 
wise to Include a computer analyst, or prbgranvrier, to wbrk with the 
subject matter specialist to design the software. The advantage of 
having a systctis analyst Is that he/she usually knows more about 
program structuring, data structuring, disk storage and retrieval 
requlreiients than a programmer. The systems analyst's knowledge might 
produce a better design, thus, reducing the amount of programming 
time. 

the complexity of the program will dictate the need for a systems 
analyst. 

A summary of the components of microcomputer sbftware design is 
Shown in Appendix B. 
PrograiuEoaing 

Once the design has been cbmpletedi It is given tb the prbgraniner 
to be eddedi The cbimhuhlcatibh lines between the designer and the 
progranraier should have already been established. The programmeri 
therefore, should already be aware of the requirements necessary to 
code the software* BuriSg this stage of development, the Interchange 
between the designer and the prbgrammer become shbrter and less 
frequent with the programmer consulting the designer only when a 
problem arises or when information is needed. 
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the programmer writing tfie code must take the responsibility to 
prepare tfie program code documentation that will facilitate program 
revision, correction and enhancement — a burdensome task to most 
programmers. However, it is very Important. A poorly dbcumehted code 
will make receding activities very difficult and extremely costly. 
The prbgrani code should be reviewed by several other programmefs to 
Insure that the code can be followed and to help potential problem 
areas. 

Final User's tfanual 

the final user's manual should build on the manual developed in 
the design step of software development and should be a joint effort 
of the software designer(s) and prbgraniner(s) . Specific components of 
a user's manual are: 

1. Title page and liability statement. 

2. Table of contents. 

3. Operational instructioos with loading and exit procedures. 

4. Screen explanation^ both data entry and outputs. 

5. Formulas and ealeulatibh procedure^ 

6. Definitions used in the program and manual, 

7. References arid sources of supporting Information. 

Few programs are well documerited arid fewer have good, complete 
user's mariuals. A program's quality and often usefulness, is a 
furictibri of completing a documentation. Technical Writers can be 
helpful in completing this hard-to-finish final step arid add to the 
quality of the user's mariual. 

The firial step in program development is program reviewi 
verifications field testing and revisibri^ Tlie time required for this 
activity deperids eritirely bri how well the design was thought throughi 
coinmuriicated to the programmer and Win e^eecuted fhto a program. At 
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this phasij numefbus people should test the program's effectiveness by 
running the program, reviewing the documentation i examining the 
subject matter and algorithms, and checking out every aspect of the 
newly developed software. This activity should also be carried out by 
some of the anticipated users of the program. User input is sought 
throughout the development process* but real interest and useful 
advice is easier to attain after the user can run the program on a 
computer and Iodic over a manual. It is often helpful to get 
unfamiliar users to evaluate the program in a field-testing 
environment to get positive feedback oh ways of improving the program. 
The review process involves testing all the options of the program as 
well as making sure that proper error checking methods are employed to 
insure a user-friendly product* After completien of this step, and 
the reprogramming is completed, the software can be released for 
distribution. 

Softiere Distflbittlbh and Naintoiance Support 

When ah individual or organization makes the decision to share 
software, the need for a distribution procedure, software support and 
maintenance begins* this is a costly activity which offers little 
opportunity for creativity or rewards associated with sol'tware 
development. Software, however, has only a limited value, if it is 
hot distributed and supported for a wide audience^ 

The most efficient means to provide software distribution and 
support is through a centralized distribution and support unit. 
Individual authors pi-bvide the software to this unit, and users order 
software from the centralized unit. This takes the day-to-day 
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distribution activitar out of the hands of developers and allows a more 
efficient use of limited resources. The distribution unit facilitates 
and encourages participants to develop and complete software for 
distribution. Miich of the software support can also be handled by 
this unit, particularly in regard to computer and software operation 
issues. Subject matter support reqiiiranehts most often must be met by 
software authors. 

Since no software is perfect, software maintenance and 
enhancenent capabilities are required* The dynamics of micrbcbmptiter 
technology has also required maintenance capability to respond to 
changing technology. The responsibility of software maintenance and 
enhancement must be a combination of the authbr(s) and the 
distribution unit. 

Software that is well designed, rigorously reviewed, and 
supported by good users' manuals will require less education and 
maintenance support « For this reason, good design, documentation of 
software and indepth reviews should be encouraged. 

Other issues that must be addressed for successful software 
distribution include: 

1. Developent of ebrhmoh standards and review procedures. 

2* Setting distribution fees. 

3i Software copywriting. 

4. Software code release. 

An efficient distribution unit can not drily encourage more author 
participation but offers a tremendous opportunity for the successful 
use of microcomputers. 
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APPENDIX k 

Pbtoitlal^eas of Mlci^oiputer Use In Finance 

And Economics 1n Developing Countries 



Fara Level (to address extension agent or farm manager needs) 

1. Financial statements 

- cash flow, Income statement^ balance sheet 

2. baj to day funds managanent 

- cash flow 

- accounts payable and receivable 

- farm accounting 

* Individual farm or cooperative 



3. Enterprise budgeting 

* crops and livestock 
Partial budgeting 

* jnarginal analysis 
Hhble farm budgeting 

* systems level 

4. Use, of budgets to evaluate 

- marketlni alternatives 

- technologies 

- Investment alternatives 



5. investment analysis 

- net present values analysis - capital budgeting 

- loan I payments^ costs etc ^ 

- Investment alternatives 

* financing terms, lease vs. buy etc. 

6. Family support i cash flow projections and managements 

7. Livestock 

- ration formulation 

- performance evaluation using economic criteria 
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Machlnery economics and finance 
Cost^ 

- capacity 

- efficiency 
ReplacaHent^ 
Investment alternatives 
Records! _ 

- use level- 

- maintenance 

- scheduling 

- machinery selection 

- matching equipment 

Inventory management 

- Inputs 

- livestock and crop 
Extension teaching preparation 



Ecbnbmic_ analysis of input use 

- economic threshold for pesticides 

- production response for inputs 

- partial budget use for input use decisions 
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APPBIDIX B 



SiMnry of the j^Miwhehts of Nlcrocoaputer 

Software Design 



For Softmre Coded In Pf^trnlng Language 

1. Objective statement 

2. D1agram(s) of program structure and linkages (flow charts are useful) 

3. Data input screen format 

- Columns 1 through 79 are used 

- Some lines are used for titles, messages, and borders leaving 
the rest for data entry. 

- Specify data range for each entry 

4. Mistake correction routine specification 

5 . dutput screen format 

- TWO types of output 

* video 

* printer 

- Columns 1 through 79 

6. Calculation procedure 

- Label each variable 

- Specify each equation 

7. Harioally worked out example for each data entry and output option 

8. Usir manual with following components 

- Title screen _ _ 

- Operational instructions 

- Screen explanation (data input and Output) 

- Definitions 

- formulas and calculatibh procedure 

- References 

- Disclaimer 
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II. Specific &Mponents of the Spreadsheet Design 

1. Title 

3i Data Input and Format 

4i Fbrmolas^ ^ 

5. Qatpat and Format^ 

6. Formula and Cell Protection Speeificatioh 
j. pefinitions ^ 

8. Guides on Operation Procedures 

9. Examples Using All Formulas and Options 

10. References 

11. Disclaimer (see example associated with language coded programs) 
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